FindWindow

FindWindow
Header:	MacWindows.h		Carbon status:	Supported

Maps the location of the cursor to a part of the screen or a region of a window when your application receives a mouse-down event.

WindowPartCode FindWindow (
    Point thePoint, 
    WindowRef *window
);

thePoint: The point, in global coordinates, where the mouse-down event occurred. Your application retrieves this information from the where field of the event structure.
window: A pointer to the window in which the mouse-down event occurred. FindWindow produces nil if the mouse-down event occurred outside a window.

function result: The location of the cursor when the user pressed the mouse button; see “FindWindow Result Code Constants”.0

DISCUSSION

You typically call the function FindWindow whenever you receive a mouse-down event. The FindWindow function helps you dispatch the event by reporting whether the cursor was in the menu bar or in a window when the mouse button was pressed. If the cursor was in a window, the function will produce both a pointer to the window and a constant that identifies the region of the window in which the event occurred. If Appearance is available, FindWindow may return the inCollapseBox constant as one of the possible window regions.

VERSION NOTES

This function was changed with Appearance Manager 1.0 to support finding events in the collapse box.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.